home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1992 June: ROMin Holiday / ADC Developer CD (1992-06) (''ROMin Holiday'')_iso / Developer Connection - 06-1992.iso / Development Platforms / Apple II / Essentials / Technical.Notes / IIGS / TN.IIGS.100 < prev    next >
Encoding:
Text File  |  1991-01-11  |  10.0 KB  |  221 lines  |  [TEXT/pdos]
  1. Apple II
  2. Technical Notes
  3. _____________________________________________________________________________
  4.                                                   Developer Technical Support
  5.  
  6. Apple IIgs
  7. #100:   VersionVille
  8.  
  9. Written by:    Matt Deatherage                                   January 1991
  10.  
  11. This Technical Note is all there is to know about versions, version formats and
  12. version numbers on the Apple IIgs.
  13. _____________________________________________________________________________
  14.  
  15.  
  16. Version Number Formats
  17.  
  18. There are three kinds of version numbers on the Apple IIgs.  Two of the three
  19. are documented elsewhere but are repeated here for convenience.
  20.  
  21. System Tool Set Versions
  22.  
  23. The Apple IIgs system tools use a one-word version number.  The high-order four
  24. bits of this word have special meaning.  Bits 8-11 are the major version number
  25. and bits 0-7 are the minor version number.  This is illustrated in Figure 1.
  26.  
  27.               +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
  28.               | F| E| D| C| B| A| 9| 8| 7| 6| 5| 4| 3| 2| 1| 0|
  29.               +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
  30.                 |  |_____||   Major   |        Minor          |
  31.                 |     |   |  Release  |       Release         |
  32.                 |     |   |___________|_______________________|
  33.                 |     |
  34.                 |     +---- 1 = Special Features
  35.                 +---------- 1 = Prototype
  36.  
  37.  
  38.                         Figure 1-Toolbox Version Numbers
  39.  
  40. Note that this definition is different and supersedes the definition in the
  41. Apple IIgs Toolbox Reference for system tool sets.  Previous documentation
  42. reserves only bit 15 as the prototype bit; this has been expanded.  Bits 14-12
  43. of user tool set version words have no special meaning; they are still part of
  44. the major release.
  45.  
  46. Note:  When comparing the major and minor release version numbers to check the
  47.        installed version of a system tool, mask off bits 15-12 first (for
  48.        example, by using an AND #$0FFF instruction).
  49.  
  50. SmartPort Or GS/OS Driver Versions
  51.  
  52. GS/OS drivers and SmartPort firmware drivers use an alternate one-word version
  53. number, described in Figure 2.
  54.  
  55.  
  56.               +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
  57.               | F| E| D| C| B| A| 9| 8| 7| 6| 5| 4| 3| 2| 1| 0|
  58.               +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
  59.               |___________|_______________________|___________|
  60.                   Major             Minor          $A = Alpha
  61.                  Release           Release         $B = Beta
  62.                                                    $E = Experimental
  63.                                                    $0 = Final
  64.  
  65.  
  66.               Figure 2-GS/OS Driver And SmartPort Version Numbers
  67.  
  68. Apple IIgs Long Version Format
  69.  
  70. Long version format is a 32-bit (two-word) format similar to the standard
  71. Macintosh version numbering scheme defined in Macintosh Technical Note #189,
  72. Version Territory, except the four bytes are stored least significant byte
  73. first, as is standard on the Apple II, and the values of the stage are
  74. different.  Figure 3 shows the format of a long version.
  75.  
  76.                High word
  77. +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
  78. |1F|1E|1D|1C|1B|1A|19|18|17|16|15|14|13|12|11|10| ...
  79. +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
  80. |     Major version     | Minor v.  | Bug vers. |
  81. +-----------------------+-----------+-----------+
  82.  Major version          |Minor      | Bug version
  83.  (2 digits, BCD)        |version (1 | (2 digits, BCD)
  84.  Example:               |digit, BCD)| Example:
  85.  $25 = Version 25       |Example:   | $4 = Version
  86.                         |$0 = Vers. | x.y.4
  87.                          x.0
  88.                                                   Low word
  89.                             +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
  90.                         ... | F| E| D| C| B| A| 9| 8| 7| 6| 5| 4| 3| 2| 1| 0|
  91.                             +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
  92.                             | Stage  | Must be zero |     Release version   |
  93.                             +--------+--------------+-----------------------+
  94.                       Stage:         |              | Release version (2
  95.                       001 = develop  |              | digits, BCD)
  96.                       010 = alpha    |              | Example:
  97.                       011 = beta     |              | Long version value of
  98.                       100 = final    |              | $25048006 = Version
  99.                       110 = release                   25.0.4f6
  100.  
  101.                          Figure 3-Long Version Numbers
  102.  
  103. Long version format allows for bug versions, unlike toolbox versions.  Also, you
  104. can do unsigned long comparisons of long versions to determine which revision is
  105. later.
  106.  
  107. Note:  If the version stage is 101 (release), the release version must be zero.
  108.        For example, you may not have version 25.0.4 release 16.  "Release
  109.        version" implies that the product is no longer under development and has
  110.        no developmental version numbers.
  111.  
  112.  
  113. System Version Numbers
  114.  
  115. The most important of the numerous version numbers in the system are the system
  116. tool version numbers.  These numbers, passed to LoadTools, LoadOneTool or
  117. StartUpTools ensure that you're getting at least the version you want, or maybe
  118. a later one.  This mechanism is your primary defense against old system
  119. software-by requiring the latest tool versions in your application, you are
  120. notified by the Tool Locator early in your program if the system has the latest
  121. system software installed or not.
  122.  
  123. Note that ROM 1 and ROM 3 have different version numbers for seven tools under
  124. 5.0.4-QuickDraw II, the Scheduler, ADB, SANE, Integer Math, Text Tools and the
  125. List Manager.  In each case, the ROM 01 version is lower and should be used in
  126. your LoadOneTool, LoadTools or StartUpTools calls.
  127.  
  128. The current revision of Apple IIgs System Software is 5.0.4.  The only system
  129. tool to change from 5.0.3 to 5.0.4 is QuickDraw Auxiliary, which changed to
  130. version 3.3.  Assuming a correct installation, requiring QuickDraw Auxiliary 3.3
  131. in effect requires System Software 5.0.4.
  132.  
  133. System Tool Set Versions
  134.  
  135.                 Number  Tool             ROM 1   ROM 3
  136.                 --------------------------------------------
  137.                  1      Tool Locator     $0300   $0300
  138.                  2      Memory Manager   $0301   $0301
  139.                  3      Misc Tools       $0301   $0301
  140.                  4      QuickDraw II     $0305   $0306
  141.                  5      Desk Manager     $0303   $0303
  142.                  6      Event Manager    $0300   $0300
  143.                  7      Scheduler        $0200   $0300
  144.                  8      Sound Tools      $0303   $0303
  145.                  9      ADB              $0201   $0300
  146.                 10      SANE             $0202   $0300
  147.                 11      Integer Math     $0200   $0300
  148.                 12      Text Tools       $0201   $0300
  149.                 14      Window Manager   $0302   $0302
  150.                 15      Menu Manager     $0302   $0302
  151.                 16      Control Manager  $0302   $0302
  152.                 18      QuickDraw II Aux $0303   $0303
  153.                 19      Print Manager    $0300   $0300
  154.                 20      Line Edit        $0302   $0302
  155.                 21      Dialog Manager   $0303   $0303
  156.                 22      Scrap Manager    $0300   $0300
  157.                 23      Standard File    $0302   $0302
  158.                 25      Note Synthesizer $0104   $0104
  159.                 26      Note Sequencer   $0104   $0104
  160.                 27      Font Manager     $0302   $0302
  161.                 28      List Manager     $0301   $0302
  162.                 29      ACE              $0102   $0102
  163.                 30      Resource Manager $0101   $0101
  164.                 32      MIDI Tools       $0103   $0103
  165.                 33      Video Overlay    $0101   $0101
  166.                 34      Text Edit        $0102   $0102
  167.                 --------------------------------------------
  168.  
  169.  
  170. GS/OS Version Numbers
  171.  
  172.                         Component             Version
  173.                         ------------------------------
  174.                         GS/OS                 3.3
  175.                         ProDOS FST            3.7
  176.                         AppleShare FST        3.4
  177.                         High Sierra FST       3.1
  178.                         Character FST         3.0
  179.                         SCSI HD Driver        1.0
  180.                         SCSI CD Driver        1.0
  181.                         AppleDisk 3.5 Driver  3.0
  182.                         AFP Driver            2.2
  183.                         RPM Driver            2.2
  184.                         AppleTalk Main Driver 2.2
  185.                         Console Driver        3.1
  186.                         AppleDisk 5.25 Driver 2.4
  187.                         UniDisk 3.5 Driver    2.22
  188.                         ------------------------------
  189.  
  190. CDev Version Numbers
  191.  
  192.                     CDev                          Version
  193.                     -------------------------------------
  194.                     Alphabet                        1.0
  195.                     AppleShare                      1.0
  196.                     AppleTalk ImageWriter           1.0.1
  197.                     AppleTalk ImageWriter LQ        1.0.1
  198.                     Direct Connect Printer          1.0
  199.                     General                         1.0
  200.                     Keyboard                        1.0
  201.                     LaserWriter                     1.0.1
  202.                     Modem Port                      1.0
  203.                     Monitor                         1.0
  204.                     Mouse                           1.0
  205.                     Printer Port                    1.0
  206.                     RAM                             1.0
  207.                     Slots                           1.1
  208.                     Sound                           1.0
  209.                     Time                            1.0
  210.                     -------------------------------------
  211.  
  212.  
  213.  
  214. Further Reference
  215. _____________________________________________________________________________
  216.   o     Apple IIgs Toolbox Reference
  217.   o     GS/OS Reference
  218.   o     GS/OS Technical Note #1, Contents of System Disk and System Tools
  219.   o     File Type Note for File Type $C7, Control Panel Devices
  220.  
  221.